home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / lfmt.z / lfmt
Text File  |  1998-10-20  |  10KB  |  197 lines
  1.  
  2.  
  3.  
  4. llllffffmmmmtttt((((1111))))                                                                llllffffmmmmtttt((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _llll_ffff_mmmm_tttt - display error message in standard format and pass to logging and
  10.      monitoring services
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      lfmt [-c] [-f _f_l_a_g_s_]]]] _[[[[_----_llll _l_a_b_e_l_]]]]_[[[[_----_ssss _s_e_v_e_r_i_t_y_]]]]_[[[[_----_GGGG _i_c_o_n_]]]]_[[[[_----_gggg _c_a_t_a_l_o_g_::::_m_s_g_i_d_]]]] _f_o_r_m_a_t _[[[[_a_r_g_s_]]]]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _llll_ffff_mmmm_tttt uses _f_o_r_m_a_t for _pppp_rrrr_iiii_nnnn_tttt_ffff style formatting of _a_r_g_s.  _llll_ffff_mmmm_tttt encapsulates
  17.      the output in the standard error message format and displays the output
  18.      on _s_t_d_e_r_r.  In addition, _llll_ffff_mmmm_tttt forwards its output to the logging and
  19.      monitoring facility.
  20.  
  21.      The following options are available.
  22.  
  23.      _----_cccc          Also display the output on the console, with a date and time
  24.                  stamp.
  25.  
  26.      _----_ffff _f_l_a_g_s    Specify logging information as a comma-separated list of
  27.                  keywords from the following sets:
  28.  
  29.                  _M_a_j_o_r _c_l_a_s_s_i_f_i_c_a_t_i_o_n
  30.                              Identifies the source of the condition.
  31.                              Identifiers are:  _hhhh_aaaa_rrrr_dddd (hardware), _ssss_oooo_ffff_tttt
  32.                              (software), and _ffff_iiii_rrrr_mmmm (firmware).
  33.  
  34.                  _M_e_s_s_a_g_e _s_o_u_r_c_e _s_u_b_c_l_a_s_s_i_f_i_c_a_t_i_o_n
  35.                              Identifies the type of software in which the
  36.                              problem is spotted.  Identifiers are:  _aaaa_pppp_pppp_llll
  37.                              (application), _uuuu_tttt_iiii_llll (utility), and _oooo_pppp_ssss_yyyy_ssss
  38.                              (operating system).
  39.  
  40.      _----_GGGG _i_c_o_n     When the output device is the graphics console start up
  41.                  screen (called the ``textport''), this option causes the
  42.                  message to be drawn in a structured alert message box.  The
  43.                  _i_c_o_n argument specifies which icon to use and is either 0, 1,
  44.                  2, 3, or 4, for Info, Progress, Question, Warning, or Action
  45.                  icons.  This option is intended to be used in start up and
  46.                  shut down scripts.
  47.  
  48.      _----_gggg _c_a_t_a_l_o_g_::::_m_s_g_i_d
  49.                  Specify that a localized version of _f_o_r_m_a_t should be
  50.                  retrieved from a locale-specific message database.  _c_a_t_a_l_o_g
  51.                  indicates the message database that contains the localized
  52.                  version of the _f_o_r_m_a_t string.  _c_a_t_a_l_o_g must be limited to 14
  53.                  characters.  These characters must be selected from a set of
  54.                  all character values, excluding _\\\\_0000 (null) and the ASCII codes
  55.                  for _//// (slash) and _:::: (colon).
  56.                  _m_s_g_i_d is a positive number that indicates the index of the
  57.                  string into the message database.
  58.                  If _c_a_t_a_l_o_g does not exist in the current locale (identified
  59.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. llllffffmmmmtttt((((1111))))                                                                llllffffmmmmtttt((((1111))))
  70.  
  71.  
  72.  
  73.                  by the _LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS or _LLLL_AAAA_NNNN_GGGG environment variables), or if
  74.                  _m_s_g_i_d is out of bounds, _llll_ffff_mmmm_tttt will attempt to retrieve the
  75.                  message from the C locale.  If this second retrieval fails,
  76.                  _llll_ffff_mmmm_tttt uses the _f_o_r_m_a_t string as passed on the command line.
  77.                  _llll_ffff_mmmm_tttt will output _MMMM_eeee_ssss_ssss_aaaa_gggg_eeee _nnnn_oooo_tttt _ffff_oooo_uuuu_nnnn_dddd_!!!!_!!!!_\\\\_nnnn as the _f_o_r_m_a_t string
  78.                  if _c_a_t_a_l_o_g is not a valid catalog name, or if _m_s_g_i_d is not a
  79.                  valid number as defined above.
  80.  
  81.      _----_llll _l_a_b_e_l    Specify the label string to be displayed with the message
  82.                  (for example, _""""_UUUU_XXXX_::::_cccc_aaaa_tttt_"""").  _l_a_b_e_l is a character string no more
  83.                  than 25 characters in length; it will be automatically
  84.                  suffixed with a colon (_::::).  When unspecified, no label is
  85.                  displayed as part of the message.
  86.  
  87.      _----_ssss _s_e_v_e_r_i_t_y Specify the severity string to be displayed with the message.
  88.                  Acceptable strings include the standard severities in either
  89.                  their print string (that is, _HHHH_AAAA_LLLL_TTTT, _EEEE_RRRR_RRRR_OOOO_RRRR, _IIII_NNNN_FFFF_OOOO, _WWWW_AAAA_RRRR_NNNN_IIII_NNNN_GGGG, and
  90.                  _""""_TTTT_OOOO _FFFF_IIII_XXXX_"""") or keyword (that is, _hhhh_aaaa_llll_tttt, _eeee_rrrr_rrrr_oooo_rrrr, _iiii_nnnn_ffff_oooo, _wwww_aaaa_rrrr_nnnn, and
  91.                  _aaaa_cccc_tttt_iiii_oooo_nnnn) forms, or any other user-defined string.  A user-
  92.                  defined string will be assigned the integer severity value of
  93.                  5.  The severity will be suffixed with a colon (_::::).  The
  94.                  _EEEE_RRRR_RRRR_OOOO_RRRR severity will be used if no severity is specified.
  95.  
  96.    SSSSttttaaaannnnddddaaaarrrrdddd EEEErrrrrrrroooorrrr MMMMeeeessssssssaaaaggggeeee FFFFoooorrrrmmmmaaaatttt
  97.      _llll_ffff_mmmm_tttt displays error messages in the following format:
  98.  
  99.           _l_a_b_e_l_:::: _s_e_v_e_r_i_t_y_:::: _t_e_x_t
  100.  
  101.      If no _l_a_b_e_l was defined using the _----_llll _l_a_b_e_l option, the message is
  102.      displayed in the format:
  103.  
  104.           _s_e_v_e_r_i_t_y_:::: _t_e_x_t
  105.  
  106.      If _llll_ffff_mmmm_tttt is called twice to display an error message and a helpful _a_c_t_i_o_n
  107.      or recovery message, the output can look like the following:
  108.  
  109.           _l_a_b_e_l_:::: _s_e_v_e_r_i_t_y_:::: _t_e_x_t
  110.           _l_a_b_e_l_:::: _TTTT_OOOO _FFFF_IIII_XXXX_:::: _t_e_x_t
  111.  
  112. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  113.      Example 1:
  114.  
  115.           _llll_ffff_mmmm_tttt _----_ffff _ssss_oooo_ffff_tttt_,,,,_uuuu_tttt_iiii_llll _----_llll _UUUU_XXXX_::::_tttt_eeee_ssss_tttt _----_ssss _iiii_nnnn_ffff_oooo _""""_tttt_eeee_ssss_tttt _ffff_aaaa_cccc_iiii_llll_iiii_tttt_yyyy _eeee_nnnn_aaaa_bbbb_llll_eeee_dddd_\\\\_nnnn_""""
  116.  
  117.      displays the message to _s_t_d_e_r_r and makes it available for logging:
  118.  
  119.           _UUUU_XXXX_::::_tttt_eeee_ssss_tttt_:::: _IIII_NNNN_FFFF_OOOO_:::: _tttt_eeee_ssss_tttt _ffff_aaaa_cccc_iiii_llll_iiii_tttt_yyyy _eeee_nnnn_aaaa_bbbb_llll_eeee_dddd
  120.  
  121.  
  122.  
  123.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134. llllffffmmmmtttt((((1111))))                                                                llllffffmmmmtttt((((1111))))
  135.  
  136.  
  137.  
  138. SEE ALSO
  139.      _gggg_eeee_tttt_tttt_xxxx_tttt(1), _pppp_ffff_mmmm_tttt(1), _pppp_rrrr_iiii_nnnn_tttt_ffff(1), _llll_ffff_mmmm_tttt(3C), _pppp_ffff_mmmm_tttt(3C), _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)
  140.  
  141. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  142.      Upon success, _llll_ffff_mmmm_tttt exits with code 0.
  143.  
  144.      Upon failure, _llll_ffff_mmmm_tttt exits with the following codes:
  145.  
  146.      1    write error.
  147.  
  148.      2    cannot log or forward to console.
  149.  
  150.      3    syntax error.
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                                                         PPPPaaaaggggeeee 3333
  194.  
  195.  
  196.  
  197.